Important: The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).billing-action { edr edr_format_name [ wait-until-flow-ends ] | egcdr | exclude-from-udrs | radius | rf } +
billing-action { create-edrs { charging-edr charging_edr_format_name | reporting-edr reporting_edr_format_name } + [ wait-until-flow-ends ] | egcdr | exclude-from-udrs | radius | rf } +
Important: This option is available only in 12.1 and earlier releases. In 12.2 and later releases, it is deprecated and is replaced by the create-edrs charging-edr option.edr_format_name must be the name of an existing EDR format, and must be a string of 1 through 63 characters in length.
Important: If the EDR format name supplied here is not configured in the EDR Format Configuration Mode, or has been deleted, the system accepts it without applying any EDR format for the billing action in this ACS service.wait-until-flow-ends: By default, the EDR is generated immediately after a ruledef hit results in this charging action. When this keyword is specified, no EDR is generated on a ruledef hit. When the flow ends, an attempt is made to generate an EDR with the format specified.
create-edrs { charging-edr charging_edr_format_name | reporting-edr reporting_edr_format_name} + [ wait-until-flow-ends ]
Important: This option is available only in 12.2 and later releases.|
•
|
charging-edr charging_edr_format_name: Specifies name of the charging EDR format to be generated.
|
charging_edr_format_name must be an alpha and/or numeric string of 1 through 63 characters in length.
|
•
|
reporting-edr reporting_edr_format_name: Specifies name of the reporting EDR format to be generated.
|
reporting_edr_format_name must be an alpha and/or numeric string of 1 through 63 characters in length.
|
•
|
wait-until-flow-ends: By default, the EDR is generated immediately after a ruledef hit results in this charging action. When this keyword is specified, no EDR is generated on a ruledef hit. When the flow ends, an attempt is made to generate an EDR with the format specified.
|
To generate an eG-CDR the accounting-mode CLI command in the APN Configuration Mode must be configured with the “none” option.
The format of enhanced G-CDRs is controlled by the inspector CLI command in the Context Configuration Mode.
By default, statistics are accumulated on a per content ID basis for possible inclusion in UDRs. The exclude-from-udrs keyword causes the system to not include the packet’s statistics in UDRs.
Rf accounting is applicable only for dynamic and predefined rules that are marked for it. Dynamic rules have a field offline-enabled to indicate this. To mark a predefined rule as offline-enabled, use this keyword and the billing-records CLI in the ACS Rulebase Configuration Mode.
in 12.1 and earlier releases, the following command enables the EDR billing type with EDR format charge1_format:
billing-action edr charge1_format
billing-action create-edrs charging-edr charging_edr_format_name reporting-edr reporting edr_format_name wait-until-flow-ends
rating-group coupon_id
coupon_id must be an integer from 0 through 65535.
Important: This rating-group overrides the content ID, if present in the same charging-action for the prepaid customer in DCCA. But only the content IDs will be used in eG-CDRs irrespective of the presence of rating-group in that charging action.charge-units units
Default: 0; disables the counter, same as no charge-units
units is the value set for charging unit, and must be an integer from 1 through 65535.
Important: For more information on content ID, refer to the if-protocol command in the ACS Ruledef Configuration Mode Commands chapter.charge-units 1024
charge-volume { protocol { bytes | packet-length | packets } [ downlink | uplink ] | constant value }
Default: charge-volume ip bytes
protocol must be one of the following:
|
•
|
dns: Charge volume for DNS
|
|
•
|
ftp-control: Charge volume for FTP-Control
|
|
•
|
ftp-data: Charge volume for FTP-Data
|
|
•
|
http: Charge volume for HTTP
|
|
•
|
icmp: Charge volume for ICMP
|
|
•
|
imap: Charge volume for Internet Message Access Protocol (IMAP)
|
|
•
|
ip: Charge volume for IP
|
|
•
|
mms: Charge volume for MMS
|
|
•
|
pop3: Charge volume for POP3
|
|
•
|
rtp: Charge volume for RTP
|
|
•
|
rtsp: Charge volume for RTSP
|
|
•
|
sdp: Charge volume for SDP
|
|
•
|
secure-http: Charge volume for secure-https
|
|
•
|
sip: Charge volume for SIP
|
|
•
|
smtp: Charge volume for SMTP
|
|
•
|
tcp: Charge volume for TCP
|
|
•
|
udp: Charge volume for UDP
|
|
•
|
wsp: Charge volume for WSP
|
|
•
|
wtp: Charge volume for WTP
|
constant units
units is the value set for charging, and must be an integer from 0 through 65535.
If constant 3 is configured for every invocation of this Charging Action, the system adds 3 to the downlink/uplink volume counter, depending on the direction of packet.
For information on supported protocols see the ACS Ruledef Configuration Mode Commands chapter.
If charge-volume rtp packets is configured, system computes volume amounts for different options for RTP as follows:
Important: Whenever service counts volume, it counts all packets that the relevant analyzers accepted.
Important: If a TCP packet is routed to the HTTP analyzer but there is no HTTP payload, then the TCP statistics will be updated but the HTTP statistics will not be updated (except for the “packets ignored by the HTTP analyzer” statistic).content-id content_id
content_id is the content ID specified for credit control service in an active charging service, and must be an integer from 1 through 65535.
If the specified ruledef uses the if-protocol command to select a value for content ID, then the content_id specified through this command is not used for billing record generation.
Important: For more information on content-id, refer to the if-protocol command in the ACS Ruledef Configuration Mode Commands chapter.content-id 23
flow action { conditional user-agent end-token end_token_name | discard [ downlink | uplink ] | random-drop interval interval_start to interval_end pkts-to-drop packet_min to packet_max | redirect-url redirect_url [ clear-quota-retry-timer ] | readdress [ server ipv4_address ] [ port port_number ] | terminate-flow | terminate-session }
flow action { conditional user-agent end-token end_token_name | discard [ downlink | uplink ] | random-drop interval interval_start to interval_end pkts-to-drop packet_min to packet_max | readdress [ server ipv4_address ] [ port port_number ] | redirect-url redirect_url [ [ encryption { blowfish128 | blowfish64 } [ encrypted ] key key ] clear-quota-retry-timer ] | terminate-flow | terminate-session }
conditional user-agent end-token end_token_name
Conditionally redirects the HTTP packets matched to a configured user-agent to a specified URL. The user agent is configured using the redirect user-agent command in the ACS Configuration Mode.
end_token_name must be an alpha and/or numeric string of 1 through 32 characters in length, and is configured with this command to end the redirection condition.
|
•
|
downlink: Discards only downlink packets.
|
|
•
|
uplink: Discards only uplink packets.
|
interval_start to interval_end: Specifies the random drop interval, in seconds, at which the voice packets will be dropped. interval_start and interval_end must be integers from 1 through 999.
pkts-to-drop packet_min to packet_max: Specifies the number of voice packets to be dropped at a time in a flow when the packets have to be dropped. packet_min and packet_max must be integers from 1 through 100.
ipv4_address must be the re-address server’s IPv4 address.
port_number must be the re-address server’s port number, and must be an integer from 1 through 65535.
redirect-url redirect_url [ [ encryption { blowfish128 | blowfish64 } [ encrypted ] key key ] clear-quota-retry-timer ]
Causes a redirect response to be returned to the subscriber, and the TCP connections (to the subscriber and server) terminated. The subscriber's Web browser should automatically send the original HTTP packet to the specified URL. Redirection is only possible for certain types of HTTP packets (for example, GET requests), which typically are only sent in the uplink direction. If the flow is not HTTP, the redirect-url option is ignored, that is the packet is forwarded normally, except for SIP. For SIP, a Contact header with the redirect information is inserted.
|
•
|
redirect_url specifies the redirect URL. redirect_url must be an alpha and/or numeric string of 1 through 511 characters in length. It may include one or more dynamic fields (up to 16 may be specified). For example, http://search.com/subtarg=#HTTP.URL#.
|
|
•
|
encryption: Specifies to enable encryption for dynamic fields of redirect URL.
|
|
•
|
blowfish128: Specifies to use Blowfish encryption with 28 bit key for encrypting the dynamic fields.
|
|
•
|
blowfish64: Specifies to use Blowfish encryption with 64 bit key for encrypting the dynamic fields.
|
|
•
|
encrypted: Specifies to encrypt the key.
|
|
•
|
key key: Specifies key to use for encryption of dynamic fields.
|
key must be a string of 1 through 523 characters in length.
|
•
|
clear-quota-retry-timer: Specifies to reset Credit Control Application (CCA) Quota Retry Timer upon redirection.
|
%3furl= can be used as a delimiter between URL. As in http://search.com/subtarg/%3furl=#HTTP.URL# format.
When a readdress server is configured for a charging action, the show configuration command will display the readdress related configuration only if server address is configured. The show configuration verbose command will display the readdress sever if configured, else will display “no flow action”.
charging-action ca_sip_redir
content-id 10
flow action redirect-url sip:test@sip.org
ruledef sip_req
rulebase plan1
This would mean any SIP request that hits the sip_req ruledef, would get redirected to the url given in ca_sip_redir. This involves creating a redirection packet with the following response line and “Contact” header in the response.
The following command resets quota retry timer upon redirection of flow to HTTP URL http://search.com/?url=#http://msn.com#:
idle-timeout idle_timeout
idle_timeout must be an integer from 0 through 86400.
flow-mapping flow_timeout
flow_timeout must be an integer from 0 through 86400.
flow limit-for-bandwidth { { direction { downlink | uplink } peak-data-rate bps peak-burst-size bytes violate-action { discard | lower-ip-precedence } [ committed-data-rate bps committed-burst-size bytes [ exceed-action { discard | lower-ip-precedence } ] ] } | { id id } }
downlink: Flow of data towards subscriber.
uplink: Flow of data from subscriber.
peak-data-rate bps
bps must be an integer from 1 through 4294967295.
peak burst-size bytes
bytes must be an integer from 1 through 4294967295.
Important: It is recommended that this parameter be configured to at least the greater of the following two values: 1) 3 times greater than packet MTU for the subscriber connection, OR 2) 3 seconds worth of token accumulation within the “bucket” for the configured peak-data-rate.|
•
|
discard: Discard the packet
|
|
•
|
lower-ip-precedence: Transmit the packet after lowering the IP precedence
|
Default: discard
bps must be an integer from 1 through 4294967295.
committed-burst-size bytes
bytes must be an integer from 1 through 4294967295.
|
•
|
discard: Discard the packet
|
|
•
|
lower-ip-precedence: Transmit the packet after lowering the ip-precedence
|
Default: lower-ip-precedence
id id
Important: This keyword is only available in 8.1 and later releases.
Important: If the exceed/violate action is set to “lower-ip-precedence”, the TOS value for the outer packet becomes “best effort” for packets that exceed/violate the traffic limits regardless of what the ip user-datagram-tos copy command is configured to. In addition, the lower-ip-precedence option may also override the ip qos-dscp command configuration. Therefore, it is recommended that command not be used when specifying this option.More information on the QoS feature is available in the QoS Management chapter of the System Administration Guide.
The following command sets an uplink peak data rate of 128000 bps and lowers the IP precedence when the committed-data-rate and the peak-data-rate are exceeded:
The following command sets a downlink peak data rate of 256000 bps and discards the packets when the committed-data-rate and the peak-data-rate are exceeded:
limit must be an integer from 1 through 4000000000.
over-limit-action action_type
action_type must be one of the following:
|
•
|
discard: Discards the packets
|
|
•
|
redirect-url: Redirects the flow
|
|
•
|
terminate-flow: Terminates the flow to which this packet belongs
|
|
•
|
terminate-session: Terminates the session to which this packet belongs
|
ip tos { af11 | af12 | af13 | af21 | af22 | af23 | af31 | af32 | af33 | af41 | af42 | af43 | be | ef | lower-bits tos_value } [ uplink | downlink ]
af xx
lower-bits tos_value
Important: In 8.1 and later releases, this keyword is “lower-bits tos_value”. In 8.0 release, it is tos_value.tos_value must be an integer from 0 through 63.
ip vlan range
range must be an integer from 1 through 4094.
ip vlan 500
nexthop-forwarding-address ipv4_address
ipv4_address must be the next-hop forwarding address for this charging action, and must be an IPv4 address.
The following command sets the next-hop forwarding address for the current charging action to 1.1.1.1:
nexthop-forwarding-address 1.1.1.1
qos-class-identifier identifier
Important: This command is controlled by the dynamic-qos-renegotiation license.interactive priority
priority specifies the traffic handling priority, and must be an integer from 1 through 3.
service-identifier service_id
[ no ] tft packet-filter packet_filter_name
packet_filter_name specifies the packet filter’s name, and must be a string of 1 through 63 characters in length.
The following command configures the packet filter filter23 to be sent to the MS:
tft packet-filter filter23
tos { af11 | af12 | af13 | af21 | af22 | af23 | af31 | af32 | af33 | af41 | af42 | af43 | be | ef | lower-bits tos_value } [ downlink | uplink ]
af xx
Specifies the use of an assured forwarding xx Per Hop Behavior (PHB).
lower-bits tos_value
Important: In 8.1 and later releases, this keyword is “lower-bits tos_value”. In 8.0 release, it is tos_value.value must be an integer from 0 through 63.
The following command sets the ToS to be for downlink packets:
tpo profile tpo_profile_name
tpo_profile_name must be an alpha and/or numeric string of 1 through 63 characters in length.
The following command configures a TPO profile named tpoprofile10 for the current charging action:
tpo profile tpoprofile10
video bitrate bit_rate_in_bps
video bitrate 300000
xheader-format xheader_format_name
Specifies an HTTP x-header (Extension header) format for readdressing. When specified, the MVG inserts a destination IP address and TCP port number in a proprietary HTTP x-header in the HTTP request to the CAE. The CAE uses this information to connect to the OS (Origin Server) to retrieve selected video clips for adaptation. xheader_format_name can be between 1 and 63 characters.
[ default | no ] video pacing by-policing [ initial-burst-duration value | normal-burst-duration value ][ -noconfirm ]
Enables the video pacing feature. When enabled, video pacing is applied per TCP video flow. The command syntax by-policing enables pacing enforcement by the policing method, which is the available method for this software release.
initial-burst-duration value
Specifies the duration, in seconds, for the allowed initial burst of video content. Note that the initial burst is configured in terms of time, so that for video files with different encoding bit rates, the amount of bytes allowed without enforcing pacing gets adjusted accordingly. The amount of bytes allowed is calculated by (video encoding rate * initial-burst-duration). value can be an integer between 1 and 30 seconds. The default value is 10 seconds.
normal-burst-duration value
Specifies the duration, in seconds, for the allowed normal burst of video content after the initial burst is completed. Like the initial burst, the normal burst is also configured in terms of time, so that for video files with different encoding bit rates, the amount of bytes allowed without enforcing pacing gets adjusted accordingly. The amount of bytes allowed is calculated by (video encoding rate * normal-burst-duration). value can be an integer between 1 and 30 seconds. The default value is 3 seconds.
video transrating target-rate-reduction percentage_of_input_rate
video transrating target-rate-reduction percentage_of_input_rate
Important: This command is license dependent. For more information please contact your local sales representative.xheader-insert xheader-format xheader_format_name [ encryption rc4md5 [ encrypted ] key key ] [ first-request-only ] [ -noconfirm ]
xheader-format xheader_format_name
xheader_format_name must be a string of 1 through 63 characters in length.
key specifies the key, and must be a string of 8 through 15 characters in length.
encryption specifies use of encryption.
The key can be configured either as plain text or encrypted. However, in the show configuration command’s output it will always be displayed as encrypted. And, in the show configuration showsecrets command’s output it will be displayed as plain text.
Also, see xheader-format CLI command in the ACS Configuration Mode Commands and ACS X-header Format Configuration Mode Commands chapters.
